In This Topic ▼

FindStudies(string,string,string,string[],string,string,string,string,string,string,string) Method

Summary

Overloaded. Runs a study-based query with the specified parameters.

Syntax

C++/CLI

public virtual DicomDataSet[] FindStudies( 
   string patientName, 
   string patientID, 
   string studyID, 
   string[] modalitiesInStudy, 
   string accessionNumber, 
   string referDrName, 
   string studyDateStart, 
   string studyDateEnd, 
   string studyTimeStart, 
   string studyTimeEnd, 
   string studyInstanceUID 
)

public: 
virtual array<DicomDataSet^>^ FindStudies(  
   String^ patientName, 
   String^ patientID, 
   String^ studyID, 
   array<String^>^ modalitiesInStudy, 
   String^ accessionNumber, 
   String^ referDrName, 
   String^ studyDateStart, 
   String^ studyDateEnd, 
   String^ studyTimeStart, 
   String^ studyTimeEnd, 
   String^ studyInstanceUID 
)

Parameters

patientName
The patient name System.String value to match the queried study against. This value can be null or System.String.Empty.

patientID
The patient ID System.String value to match the queried study against. This value can be null or System.String.Empty.

studyID
The study ID System.String value to match the queried study against. This value can be null or System.String.Empty.

modalitiesInStudy
An array of System.String which contains the modalities to match the queried study against. This value can be null or System.String.Empty.

accessionNumber
The accession number System.String value to match the queried study against. This value can be null or System.String.Empty.

referDrName
The referring physician name System.String value to match the queried study against. This value can be null or System.String.Empty.

studyDateStart
The study starting date of a System.DateTime value type to match the queried study against. This value can be null or System.String.Empty.

studyDateEnd
The study end date of a System.DateTime value type to match the queried study against. This value can be null or System.String.Empty.

studyTimeStart
The study starting time of a System.DateTime value type to match the queried study against. This value can be null or System.String.Empty.

studyTimeEnd
The study end time of a System.DateTime value type to match the queried study against. This value can be null or System.String.Empty.

studyInstanceUID
The Study Instance UID System.String value to match the queried study against. This value can be null or System.String.Empty.

Return Value

An Array of Leadtools.Dicom.DicomDataSet objects which contains the query results.

Remarks

Calling this method while the Processing property is true will result in an InvalidOperationException being thrown.

If the operation is cancelled this method will throw a ClientCommunicationCanceled exception.

Example

using LeadtoolsExamples.Common; 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Dicom; 
using Leadtools.Dicom.Scu.Common; 
using Leadtools.ImageProcessing; 
using Leadtools.Dicom.AddIn.Common; 
using Leadtools.Dicom.Scu; 
using Leadtools.Medical.Workstation.Client; 
using Leadtools.Medical.Workstation.Client.Local; 
using Leadtools.Medical.Workstation.Client.Pacs; 
using Leadtools.Medical.Storage.DataAccessLayer; 
using Leadtools.Medical.DataAccessLayer; 
using Leadtools.Medical.Storage.DataAccessLayer.Configuration; 
 
public void DatabaseQueryLocal() 
{ 
   Leadtools.Examples.Support.SetLicense(); 
 
   AeInfo clientInfo = new AeInfo(); 
 
 
   clientInfo.Address = Dns.GetHostName(); //local machine 
   clientInfo.AETitle = "TEST_CLIENT"; 
   clientInfo.Port = 1000; 
 
   IStorageDataAccessAgent dataAccess = null; 
   bool fromConfiguration = false; 
 
   if (fromConfiguration) 
   { 
      //Make sure that the Sotrage Data Access is configured before creating an instance. 
      dataAccess = DataAccessFactory.GetInstance(new StorageDataAccessConfigurationView()).CreateDataAccessAgent<IStorageDataAccessAgent>(); 
   } 
   else 
   { 
      string connectionString = @"Data Source=local;Initial Catalog=DicomStorage;Integrated Security=True;User ID=;Password=;Pooling=True"; 
      //or you can directly create the data access object which works with your database 
      dataAccess = new StorageSqlDbDataAccessAgent(connectionString); 
   } 
 
   DbQueryClient client = new DbQueryClient(clientInfo, dataAccess); 
 
   client.EnableLog = true; 
   client.LogFileName = Path.Combine(LEAD_VARS.ImagesDir, "DicomLog.txt"); 
 
   PerformClientQuery(client); 
} 
 
public void PerformClientQuery(QueryClient client) 
{ 
   FindQuery studiesQuery = new FindQuery(); 
 
   DicomEngine.Startup(); 
   DicomDataSet[] studies = client.FindStudies(studiesQuery); 
 
 
   if (studies.Length > 0) 
   { 
      DicomDataSet study = studies[0]; 
      FindQuery seriesQuery = new FindQuery(); 
 
 
      seriesQuery.StudyInstanceUID = study.GetValue<string>(DicomTag.StudyInstanceUID, string.Empty); 
 
      DicomDataSet[] series = client.FindSeries(seriesQuery); 
 
      foreach (DicomDataSet seriesDS in series) 
      { 
         FindQuery imagesQuery = new FindQuery(); 
 
 
         imagesQuery.SeriesInstanceUID = seriesDS.GetValue<string>(DicomTag.SeriesInstanceUID, string.Empty); 
 
         DicomDataSet[] images = client.FindImages(imagesQuery); 
 
 
         foreach (DicomDataSet instance in images) 
         { 
            Console.WriteLine("SOPInstanceUID: {0}", instance.GetValue<string>(DicomTag.SOPInstanceUID, string.Empty)); 
 
            Console.WriteLine("SeriesInstanceUID: {0}", instance.GetValue<string>(DicomTag.SeriesInstanceUID, string.Empty)); 
 
            Console.WriteLine("StudyInstanceUID: {0}", instance.GetValue<string>(DicomTag.StudyInstanceUID, string.Empty)); 
         } 
      } 
   } 
   DicomEngine.Shutdown(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

Requirements

Target Platforms

Reference

QueryClient Class

QueryClient Members

Overload List

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Medical.Workstation.Client Assembly

Introduction

Getting Started

Namespaces

Leadtools.Medical.Workstation.Client Namespace

Leadtools.Medical.Workstation.Client.Local Namespace

Leadtools.Medical.Workstation.Client.Pacs Namespace

Assemblies